package com.hmall.common.domain;

import com.hmall.common.exception.CommonException;
import lombok.Data;

/**
 * 统一响应结果类
 * 用于封装API接口的返回数据，包含状态码、消息和数据
 * @param <T> 响应数据的类型
 */
@Data
public class R<T> {

    /**
     * 响应状态码
     */
    private int code;

    /**
     * 响应消息
     */
    private String msg;

    /**
     * 响应数据
     */
    private T data;

    /**
     * 创建成功响应（无数据）
     * @return 成功响应实例
     */
    public static R<Void> ok() {
        return ok(null);
    }

    /**
     * 创建成功响应（带数据）
     * @param data 响应数据
     * @param <T> 数据类型
     * @return 成功响应实例
     */
    public static <T> R<T> ok(T data) {
        return new R<>(200, "OK", data);
    }

    /**
     * 创建错误响应（默认错误码500）
     * @param msg 错误消息
     * @param <T> 数据类型
     * @return 错误响应实例
     */
    public static <T> R<T> error(String msg) {
        return new R<>(500, msg, null);
    }

    /**
     * 创建错误响应（自定义错误码）
     * @param code 错误码
     * @param msg 错误消息
     * @param <T> 数据类型
     * @return 错误响应实例
     */
    public static <T> R<T> error(int code, String msg) {
        return new R<>(code, msg, null);
    }

    /**
     * 基于业务异常创建错误响应
     * @param e 业务异常
     * @param <T> 数据类型
     * @return 错误响应实例
     */
    public static <T> R<T> error(CommonException e) {
        return new R<>(e.getCode(), e.getMessage(), null);
    }

    /**
     * 默认构造函数
     */
    public R() {
    }

    /**
     * 全参构造函数
     * @param code 状态码
     * @param msg 消息
     * @param data 数据
     */
    public R(int code, String msg, T data) {
        this.code = code;
        this.msg = msg;
        this.data = data;
    }

    /**
     * 判断响应是否成功（状态码是否为200）
     * @return 成功返回true，否则返回false
     */
    public boolean success(){
        return code == 200;
    }
}